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1 INTRODUCTION 


1.1 About this document 

In this user manual the names of interface items (windows, (tab) pages, fields, and menus) are printed in italic, 
while user controls (keyboard keystrokes, mouse or trackball clicks, edit controls, check boxes and menu 
choices) are indicated in bold print. 


Symbol 


An orange dot indicates a point of interest. 


A red exclamation mark indicates an important remark. 





This Tracxer Code Reader Software user manual is installed in PDF on your computer upon installation of the 
Tracxer program. 


1.2 About the system 

The Tracxer program incorporates a flatbed scanner with a special cover on it and an image analysis program 
that runs on a PC (or laptop or notebook), which is connected to the scanner via a USB cable. The software 
reads and decodes the 2D codes on the bottoms of tubes that are placed in a storage rack. The read tube codes 
plus an optional 1D rack barcode (obtained from an external side barcode scanner) can be stored on a hard disk 
or sent to an optional host computer. 





2 QUICK GUIDE 


For operators of the Tracxer program who only need to know the daily operating procedures of the system this 
chapter shows the sequence of actions that is required to correctly start, use and stop the Tracxer program. 


2.1 Start 
e Switch on all systems. Please see also the ‘Getting Started’ manual. 
e The Tracxer program will start automatically (if not log in to Windows and double click on the Tracxer 
icon to start the Tracxer program). 
e Log in with your name and password. 
e Click on Scan & Export to start scanning and decoding. 


2.2 Stop 
e Click on the Close button to exit the Tracxer program. 
e Close down Windows (click on the Start button of Windows, select Shut Down..., etc.) After a while the 
computer will shut down. 


If you power down the PC while Windows is still running, vital parts of both software and hardware can be 
damaged! 


On rare occasions after closing down the Tracxer system the program will stay in memory. It will not be possible 
to start the program again. To solve this situation start the Task Manager (Right Mouse Click on the Windows 
Task Bar, select the Task Manager) and select the Processes tab. Select ‘Tracxer.exe’ in the first column. Click 
the End Process button and confirm. 


Tracxer Code Reader Software User Manual 


A PROGRAM INTERFACE 


3.1 Users 
The Tracxer program has various ‘types’ of users, each on his own user level. Each user has to log on to the 
software before he can control it on the level that has been allocated to his User Name and Password. This user 
level determines which functionality is accessible. Users on a higher level have more rights (and more 
responsibilities) than lower-level users. The bottom level is ‘logged-off. 
The Tracxer program comes preinstalled with the following users and passwords: 

e AdminNoPWD~ - (Administrator level) 

e SuperNoPWD~ - (Supervisor level) 





If you leave the program unattended for longer than a pre-defined period of time, you may automatically be 
logged off. 


3.2 Controls 

The numeric edit controls have more functionality than usual. When a control has focused, its value can be 
changed using the mouse wheel, the arrow keys and the bar below it. Also if you click and hold a control for two 
seconds a pop up appears in which you can change the value. 


3.3 Log on — Log off 

Before you can use the Tracxer program to its full extent on your User Level, you will need to log on to it. Click 
the Log on button in the Main Toolbar or press the function key F2 on the keyboard to get the Login pop-up 
menu. 


Please pay attention to using the correct (lower or upper) case for the characters you type! 


User Name ( AdminNoPWD S 


Password | | 


ERRORS See 
SAREE 
TESS Soe 

aa 





When all users, including the supplier's service desk, are unable to login because they forgot their user names 
and passwords, and remote support is not possible, Micronic can supply a temporary login password code. You 
must click the Keys Icon (see red circle in the image above) and forward the shown code to the service desk. 


Micronic will generate a code (for a specific user level) that the customer can use as a password to login to the 


Tracxer program. Once the user is logged in he can make new users at the desired user levels. The generated 
password code expires at 12:00 pm of the day it was generated. 
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3.4 Toolbar 


“> Tracxer 








a E 








Home Scanner Advanced Log on CODE READER 


Always visible is the main toolbar. We use this toolbar to switch between pages of the program. 


When the Tracxer program is in detection mode it awaits products. Every product that passes the scanner from 
now on (until detection mode is stopped) will be checked by the Tracxer program. The images that are acquired 
from the products are shown in the Image Display section on the Home Page. 


All the different pages will be discussed in the following chapters. 

Home; shows the most important statistics, status information and images from production. 
Scanner; decoding and scanner settings. 

Advanced; application settings, i.e. barcode devices, output files and user management. 
Log off/Log on; users can log on or log off. 

Help; shows the Tracxer user manual. 


3.5 Status Bar 





The status bar shows information about the program. From left to right: 
e The last warning or error message (also see the System-History page). 
e Location Name, here “LAB001”. 
e Current user and user level. 
e Clock showing the current time. 


3.6 Side Bars 
On every page there is a side bar on the left of the screen. Use these side bars to select subpages. These 
subpages will be discussed in the concerning chapters. We will also refer to them as ‘pages’. 


3.7 On-the-fly Changes of Settings 

In the Tracxer program it is possible to change most settings while in detection mode. Changing settings on 
Scanner or Advanced Pages will not interfere with the current production until Apply New Settings has been 
clicked. Buttons on the Home Page have an immediate effect on production. 


3.8 Apply New Settings and Undo Changes 

After making any changes you need to click the Apply New Settings button to use the new settings in 
production, or click on the Undo Changes button to refrain from using the new settings and restore the ‘saved’ 
values. 


When you change a parameter, its new value is tested immediately on the current image: you will see the effect 
in the Image Display. It will not be used for production yet. Only after you click the Apply New Settings button, 
all new parameter settings are taken ‘into production’. 

So, if you leave the Scanner Pages without applying, your new settings are not used in production. 


As soon as you click Apply New Settings, the Undo Changes button has no effect anymore, because applying 
overwrites the ‘saved’ settings. 





P d : 


= = i Ai j 
Ge d Sé | | 
(3 Sy A f 








E géi 
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4 HOME PAGE 


On the Home Page we see a side bar, a display for the scanned images, and a list with the last decoded results 
and finally there is an area with status information of several devices or controls. 


oo Tracxer 


KR 


Scanner Advanced Log off CODE READER 


| 1D 

4002257994 

4002258006 

4002258018 

4002258030 

4002258042 

4002258054 

4002258066 

4002258078 

4002257995 

4002258007 

4002258019 

4002258031 

4002258043 

4002258055 

4002258067 

4002258079 

4002257996 

4002258008 

4002258020 

4002258032 

4002258044 

4002258056 

4002258068 

4002258080 

—< 4002257997 

ID | 12345678 4002258009 
2 4002258021 
4002258033 
4002258045 
4002258057 
4002258069 
4002258081 
4002257998 
4002258010 
4002258022 

















There are / options in the sidebar: 

e Scan & Export; this option is a combination of the other buttons. It runs through the options sequentially: 
scan an Image, decode the image, read the rack ID and save Results. 

Scan Image; scans a new image. 

Decode Image; decodes the last acquired image. 

Save Image; saves the current image. A pop up will be presented to enter the filename. 

Read Rack ID; reads the Rack ID using either a serial device or a keyboard wedge. 

Edit Results; gives the option to edit the results of a single tube manually. 

Save Results; saves the decoding results of the scan to an output file and/or automation. 


Please notice that the Image Display will be black until the production is started and the first image has been 
acquired by the scanner. 


4.1 Status Information 
In the Status area we have four fields showing important information about the system devices: 


e > Scanner, shows which scanner is currently being used 
e 4 Barcode Reader, if a serial barcode scanner is connected its status will be shown here 


e. 
e ` "7" Remote control, shows if a remote control client is connected 
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e a Automation, shows which type of automation has been selected and if the process works correctly 


When a status is green the device is working correctly. When a field is yellow the status is unknown but the 
application can continue working. When the status is red there is a problem which needs to be fixed in order for 
the device to continue working properly. 


Next to the devices are the decode results shown: 


e M Tray ID, shows the received or entered code of the tube rack 
e ` "e The number of tubes read correctly 
e ` oe The number of tubes which could not be read 


e & The number of tubes which were detected empty 





e 5 Single tube ID (when single tube reading is enabled) 


5 SCANNER PAGE 


Before you can start adjusting the settings make sure an image of a correct product is available in the Image 
Display. When adjusting or testing certain parameters it can be helpful to have an image of a product with one or 
more defects available. 


In the Side Bar on the Scanner Page you'll find the following options: 


e General Settings for the rack and rack and code options. 
e TraXis Settings for TraXis decoding. 

e Datamatrix Settings for Datamatrix decoding. 

e Source Settings for Scanner selection and scanner area. 


Click on Apply new Settings button to use the new settings in production. 


5.1 Display and Image Controls 
This paragraph is valid for all Scanner Pages. 


On many pages an image is visible. On the Home Page these are images from production (depending on the 
display settings). On the other pages the images come from the review set of images or from disk. According to 


the review settings images from production are copied to the review set. A mouse right click in the image will give 
you some options to manipulate the display. 


aS R 


The buttons under the image display on the scanner pages do, from left to right, the following: 


OC 


e Zoom In: Zoom in the Image Display. Clicking the left mouse button increases the zoom factor. A single right 
mouse button or a left mouse click outside the display, exits the zoom in tool. To set a permanent zoom 
factor you can right click in the Image Display. 

e Zoom out: Zoom out the Image Display. 

e Scroll: Scrolls the Image Display when zoomed in by moving the cursor to the sides of the Image Display. 

e Magnifier Zoom: Start and stop a magnifier zoom. Use the mouse wheel to control the zoom factor. Move 
the cursor to the place you wish to enlarge. A single left mouse click outside the display will also exit the tool. 

e Open Image: Load an image and run a measurement. 

e Save Image: Save an image for later use. 
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5.2 General 
This section gives the possibility to change rack specific settings, which will be used for reading. 


«> Tracxer 


Advanced Log off CODE READER 


Leg -o 
General Type | 96 [8x12] 





Name |96 [8x12] 


Code Polarity | White On Black 


Code Type [MÍ Datamatrix [MÍ Traxis 


Position 
Offset x | 


Size x 2540 


Tube Detection 
Threshold 5 


[C] Show Filtered Image 


" ` Cells OK [Mi cells NOK 


E a 
Apply New Settings Undo Changes di e 
E" Se 





5.2.1 Rack Types 


The rack type can be selected with the type combobox. The first 5 types are predefined. They are the 384, 96, 
48, 24 and 12 types. These five cannot be removed. The parameter of these type can be altered. 


In the picture below also two user defined types are generated. Making a new type is done by selecting the last 
type, the dash. Once selected, the name can be edited and after applying the settings, the new type is available. 


Rack 


Type | 96 [8x12] 


384 {16x24} 
Name 


96 f8xi2Z} 
Rows 48 {6x8} 
24 f4x6} 
Columns 12 [3x4] 
Cell Size j 





Each type has a number of parameters which can be changed, and will be stored along with the type: 


e Name : How to relate to the type 
e Rows : The number of cells vertically 
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e Columns ` The number of cells horizontally 

e Cell Size : The effective size of the scan area, which is being used for decoding. This size is 
displayed in the Image Display as yellow squares. 

e Code Polarity ` ` Is the code applied black on white, white on black or can both types be found? 
According to this setting, the decoding will use one fixed type or look for both types. 

e Code Type : Datamatrix and TraXis can be decoded using the Tracxer program. Deselecting a 


code type here will disable the decoding of this type in production. This will reduce 
the overall decoding time of a rack. 

e Rack Position : The position of the decoding area can be set here. The position is displayed in the 
Image Display as a blue matrix. 


Rack 





we Teen "e 
Name | 96 P x EI 
Rows 
Columns 12 
Cell Size | 1480 ` 
Code Polarity | White On ge Je 


Code Type bi Datamatrix ` NW Traxis 


Position 








offset x | 19 |y| 150 | 








Sie xX | 2540 (xl 170 | 








5.2.2 Tube Detection 


Using the threshold setting a limit can be set so the empty tube can be detected correctly. 
In the Image Display the current value can be seen for each tube. When the current value is above the Threshold 
the text will be displayed in yellow, if it is lower the text will be blue. 


Tube Detection 


Threshold | so | 





[| Show Filtered Image 


5.2.3 Options 


An overlay can be displayed in the /mage Display during production which draws a circle around each decoded 
tube. 

e Draw Cells OK: draws a green circle around the tubes which have been decoded successfully. 

e Draw Cells NOK: draws a red or orange circle around the tubes which did not decode properly. 


` Cells OK bw cells NOK 


5.3 TraXis 
This section gives the possibility to change TraXis specific settings which will be used in production. 
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“> Tracxer 
CODE READER 


Threshold | 35 
Fiter | 40 


Traxis ` ` Show Filtered Image 


Minimum | 


Maximum | 60 


20999 


vi Draw Codes 


Factory Defaults 


Säeeeererere 
OS SOSOee 
OSOOoS OD e 
POOSSOoo 
DOODO 
LAA AAAA A A 
Gëieeeenee 
See er erer 
OODOOSS SO 
OOODeSOS eo 


8 
8 
K 
KE 
K 
® 
K 
© 


Apply New Settings Undo Changes | 





The Threshold and Filter determine the size (and automatically also the shape) of the area that defines the 
bottom of each tube. The /mage Display shows these areas in white on a dark background when the Show 
Filtered Image has been checked. Modify the Threshold and Filter value until each TraXis dot of all 96 bottoms 
are Clearly visible and as big as possible. 


Adapt the Minimum Size and the Maximum size of the tube bottom areas. Only tubes whose (threshold) white 
areas have sizes between (and including) the Minimum and Maximum sizes will be analyzed further, both during 
Set-up and Production. The closer you reach the ideal settings of these parameters, the more tube bottoms will 
be shown with the code drawn in them in blue and yellow. 


Correct settings Incorrect settings Incorrect settings 
Reason Code dots are too large and Code dots are too small and 
there is too much noise. cannot be recognized. 


Image 





5.4 Datamatrix 
This section gives the possibility to change Datamatrix specific settings, which will be used in production. 
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«> Tracxer 


Datamatrix 


Code Size 
Minimum | 300 
Maximum 9000 





[C] Show Filtered Image 


Draw Codes 


Factory Defaults 





Apply New Settings Undo Changes 





Adapt the Minimum Size and the Maximum size of the tube bottom areas. Only tubes whose white areas have 
sizes between (and including) the Minimum and Maximum size will be analyzed further, both during Set-up and 
Production. The closer you reach the ideal settings of these parameters, the more tube bottoms will be shown 
with the code drawn in them in blue and yellow. 


Check the Show Filtered Image to display the filtered image on which the decoding is done. 


5.5 Source 
This section gives the possibility to change Scanner specific settings, which will be used in production. 
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«> Tracxer 


CODE READER 


Scanner 


Source | RS210 - Fujitsu Een |% 


Rack Scan 


E woo |p) ag | 





Image Processing 


Rotate | Left | 7 | 
ab 
Mirror | Vertical | v 


Single Tube Read 
Source 


x| oo |y¥{ oo 
Dx | 260 |py| 260 


Scan 








Using the Source selection, a connected scanner can be selected and its pre-sets will be loaded if it is available. 
To activate the scanner the Apply New Settings button must be pressed. From this moment on the new scanner 
can be used in both production and setup. 


The Tracxer program does not acquire an image from the total A4- or A5-format area of its glass plate, but only 
from an area with a size that is slightly larger than a tube rack. You may modify the position of this “field of 
vision’. It must coincide with the opening in the cover on the scanners’ glass plate, in which the tube racks need 
to be placed. 


Fine tuning of the image cut-out can be done with the Scan Offset parameters X and Y. The size of the image is 
predefined and cannot be altered. 


Click on the Scan button to acquire an image from the scanner. Adapt your settings until the entire tube rack is 
visible on the monitor. You can verify if the scan area is correct by opening the General page and checking if all 
tubes are in the middle of their cell. You might use the zoom function of the Mouse Menu (please refer to section 
4.6) for optimal view on the entire tube rack or on specific tubes. 


The Rotate and Mirror options can be used in case the scanner outputs its image in a different direction than the 
Tracxer program might expect. See separate document for known scanner specific settings. 
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6 ADVANCES PAGE 


The following pages are available (depending on the user level): 


e History All system messages: information, warnings and errors. 
e Devices Setting for code reader, automation and remote control. 
e Settings General system settings. 

e Output File Setting for the output file. 

e Users Managing users, user levels, passwords. 

e = Rights Managing user rights. 


6.1 History 
This page shows a list of the most recent messages. These messages appeared in the Status Bar on the 
moment they occurred. 


Three types of messages can occur: 
e Information: informational message. No action required. 
e Warning: warning message. The system can continue detection. Try to solve the problem. 
e Error: severe problem that can cause detection to stop. You need to solve the problem. 


N 


Scanner Advanced Log oft CODE READER 


Time | Source | Message 
20-08 11:13:38--267 User Manager AdminNoP¥yD [Administrator] Logged on 
20-08 11:13:35--262 User Manager Logged Off 
20-08 11:12:31--056 User Manager Logged Off 
20-08 11:12:31--038 TwainScan Scanner 'RS210 - Fujitsu Fi60' autoselected. 
20-08 11:12:29--193 Application Loaded LOG: C:\Data Files'\Logs\Tracxer.Log 
PE i 20-08 11:12:29--193 Application Loaded XML: C: Wsers‘ibk\DesktopiTracxer.xml 
20-08 11:12:29--193 Application Loaded INI: C:\Data Files\Tracxer\Tracxer.INI 
20-08 11:12:29--183 Using Framework 1.9.15 
EE 20-08 11:12:29--183 Application Tracxer 42.2.6 Started 


Devices 


Settings 


Output File 
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6.2 Devices 

On this page are several sections: 
e Barcode Reader 
e Automation 
e Remote Control 


For more information about the Bardcode Reader please check the User Manual at www.Micronic.com. 
1. Click on ‘login’ on the top right of the website 
2. Username: support, Password: manuals 


Further information about Automation and Remote Control can be found as of chapter 8 in this user manual. 


«^ Tracxer 


CODE READER 


Barcode Reader Automation 


Port 
Application | Excel | Ké 
Number | None |% , 
Macro | ImportResults | 


Baudrate om «0 Le ES 
Parity | Even |% Test 
stopsits [1 Le —— Se 


Commands 





w 





Status | 





Trigger | 60 || 116 |[ 62 |{ 0 | 
Pre-amble l 0 | l 0 | | 0 | l 0 Remote Control 


Post-amble | 13 |{ 10 | o |{ o | Connections | 0 


e 





Status | Unknown | 
Apply New Settings Undo Changes | 








6.2.1 Barcode Reader 


On the Devices Page you can specify the layout of the message that is to be sent by the Tracxer program to the 
1D barcode reader. This message will command the barcode reader to read the barcode from the tube rack that 
sits on the scanner cabinet at that moment, and to send that code to the Tracxer program. You may also specify 
to which port of the Tracxer program the barcode reader will be connected. 


On the 5 lines below the number button, you can specify the various settings for the selected port. 


On the lines Trigger, Preamble and Post-amble, you may specify the ASCII codes (in decimal numbers) that 
are sent and received within the messages. 


Click on the Test button to start testing the (communication with the) barcode reader, and click Test once again 
to stop testing. The read code is shown in the Result box. 


lf the communication is faulty, an error message indicates the cause of the problem (as far as possible). 
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6.2.2 Automation 


In this area you can specify which program has to act as Automation Server for the Tracxer program. 


In the Application section you may specify the name of the program that has to be automated, the options are 
Excel and Access. 


In the Macro to Run section, specify the name of the macro that will start the application. 


Click the Test buttons to check if the specified application can be automated successfully with the given macro. 
The Status field show the results of the test in two levels of detail. 


e The Automation Server must be started with a document that contains the macro (or procedure) that 
you specified above. 

e In order to start some applications (like Access), the specified macro must be in Visual Basic format. If 
required you may have that application convert the macro to that format. 


Automation 


Application | Excel E | 





Macro | ImportResults 
Test 


Test 





Result 


Status OK 





6.2.3 Remote Control 


The Remote Control section does not offer any setting in this version. Only the general status and the number of 
connections is shown. 


When a Remote Application makes connection to the Tracxer Application it will be shown. 
Remote Control 


Connections | 0 | 





Status | OK 
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6.3 Settings 
On the Settings page several common parameters can be set. 


CODE READER 


r General S Single Tube Read 


History Location | NoName | [Mi Enable Single Tube Read 


/ d 1 Show Close Button 





Devices 
[C] Show Shutdown Button 


Lt g Show Location in Statusbar Change Scanner translations | 


Settings 


Output Fite Control 


`" ` Enable Automation 


[ ` Beep with each Measurement 


g Show Preview Dialog before 
Saving Results 





[C] Output Overwrite Warning 


— Folders 





Images | C:\Data Files\lmages 
Log Files | C:\Data Files\Logs 


Apply New Settings Undo Changes 





6.3.1 General 


The general section offers some useful user interface options. 


The Location field gives you the ability to give a unique name to the Code Reader. This name can be used for 
registration of the origin of the results. If you have more than one reader, this can be useful. 


-~ General 


Location | LAB 001 | 


iv Show Close Button 
IM) Show Shutdown Button 
iv Show Location in Statusbar 


[| Beep with each Measurement 


With the Show Close Button option, you can show or hide a button to close the application in the main toolbar. 
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Similar the Show Shutdown Button option, can show or hide a button where with the PC can be shutdown. 


When you check Show Location in Status bar, the name which has been entered in the location field will 
appear in the Status bar. 


When you change one of the above options, you have to press the Apply New Settings and also have to restart 
the Tracxer program before the settings will become active. 


6.3.2 Control 


Here the behavior of the “Scan & Export” action can be arranged. 
Control 


Rack ID Source | None | éi 


iv Enable Automation 


— Show Preview Dialog before 
— Saving Results 


` ` Output Overwrite Warning 


The following options are available: 
e Rack ID Source: define if and what the connected barcode reader device is. Options are: 
o None: the rack ID will not be read. 
o Serial Device: the device configured at the Devices Page — Barcode Reader will be used. 
o Keyboard Wedge: this will at pressing the Scan & Export button, show a popup dialog box 
where an rack ID can be entered manually or a connected keyboard wedge can be used to 
scan the barcode of the tube rack. 
e Enable Automation: whether or not to perform automation after the decoding. 
e Show Preview Dialog before saving results: will show a popup dialog with the decode results. 
e Output overwrite warning: can be enabled to show a warning when an output file is about to be 
overwritten. Depending on the way of re-scanning this might be unwanted, in that case, the warning can 
be suppressed. 


6.3.3 Folders 


The Folders section lets you define where the log files will be written and where the default folder for the images 
is located. When opening or saving an image always a popup dialog is shown and you can select other folders. 


Folders 


-e CS 





LogFies (fan FilesLogs e Il 





To change the folder, press the button on the end of the edit box and a popup dialog will let you select the new 
location. 
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6.4 Output File 
The Output File Page lets you define how the results will be stored. Here, the name of the consecutive files, the 
location of the files, and how and what the contents of each file are, can be defined. 


“> Tracxer 


CODE READER 


Filename Formatting Records 


Seperator | Space Seperator | Comma 


Sorting | Column Wise (401 B01 C01 el 


Free Text | FILE Include Field Names 


M Header 
Sequence Number , Fields 
SS Free Text | header | e 
Digits | 3 | f Line Start [Mj | Start text 
Composition 


Start Value | o | 


[| Reset at Program Startup 


Composition 


1 | Free Text 
2 | Sequence Number 
3 | Rack ID | 


1 
2 | Tube ID | 
3 | Status | 


4 | Error Count | 
5 | Rack ID | 
6 | Date |Y 


Line End | End text | 


4 | Date 


D | Time |% 
6 | el 


[vi Footer 


Free Tet | footer [| Add Seperator 


Extension | CSN 


[| Add New Line i One Record per Line 


Output 


M One Rack per File 


Preview 


Folder | C:\Data Files\Output 





Example | FILE 000 70200039 20140820 113647.csv 


Apply New Settings | Undo Changes 








6.4.1 Filename 


In the Filename section, the name of the output files can be composed. The name will be constructed by 
elements which can be chosen in the Composition sub section. The following options are available: 
e Date: this will add the current date to the filename. The format is: “yyyymmdd”. 
e Time: this will add the current time in the format “hhmmss’” to the name. 
e Sequence Number: this will add a number to the name. The number will be increased by one after 
each “Scan & Decode”. The format and start value can be set in the Sequence Number section. 
e Rack ID: this will add the read or entered ID of the tube rack to the filename. 
e Free Text: this will add the entered free text to each saved file. If for example a specific batch must be 
label uniquely, here you can enter the specific string. 


The separator lets you define the character which will be put between the different elements. The following 
characters are available: 


e Space 

e Underscore 
e Dash 

e Plus Sign 


Next, there is the Free Text element. The here entered string will be used one on one in the filename. This might 
be handy to distinguish a certain group of racks afterwards. 
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Filename 


Seperator | Space | di 





Free Text | FILE 


Sequence Number 


am 
Start value | o |] 
[C] Reset at Program Startup 
Composition 
en e 
2 | Sequence Number | se 
Ber 
4 | Date hd 
d KA 





Extension | „csv 


The Sequence Number element can add numbering to the filename. After each “Scan & Decode” the value will 

increase by one. The number of digits can be set. This will define the maximum value. Reaching the maximum, 

the number will start from 0 again. The number of digits will also be used for the formatting of the string; missing 
digits will be proceeded by zeros. The Start Value lets you enter the desired number to start with. 


Next in the Composition sub section the elements can be chosen. There are 7 possible entries, each gives you 
the same selection. The order is decisive for the position in the name. 


Lastly, you can define an Extension for the filename. Default the extension is “csv”, but you are free to enter any 
string you like. 


6.4.2 Formatting 


In the formatting section one can define how the global format of the contents are. One can select a character by 
which all fields must be separated. Possible characters are: 
e Comma 
Comma and Space 
Semicolon 
Colon 
Tab 


Formatting 


Seperator Comma | P| 
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6.4.3 Header 


Optional you can add a free text to compose header in the file. With the checkbox in front of the group box name 
this is switched. 


Again there are a list of options you can select from: 
e Date: this will add the current date to the header. The format is: “yyyymmdd”. 
e Time: this will add the current time in the format “hhmmss’. 
e Sequence Number: this will add the sequence number. The format and start value can be set in the 
Sequence Number section. 
e Rack ID: this will add the read or entered ID of the tube rack. 
e Free Text: this will add the entered free text. 


iv Header 


Free Text header 





composition 


2 | Sequence Number e 

S Gries 

‘(oe iv 

d e 
6.4.4 Footer 


Optional you can add a free to compose footer in the file. With the checkbox in front of the group box name this 
is switched. 


Only two option for the footer are available: 
e Free Text: this will add the entered free text 
e Add New Line: For will insert an empty line after each footer. This might come handy for manual 
looking through saved files. 


iv Footer 





Free Text footer 


[| Add New Line 


6.4.5 Records 


For the each decoded tube a record will be written in the output file. In the Records section the following list of 
options is available to store per tube: 
e Tube ID: the recognized or decoded ID of a tube. 
e Position: the position of the tube inside the rack. The format is a character per column and a number 
per row. 
e Rack ID: the read or entered ID of the rack. 
e Status: the result of the decoding. The following states are possible: 
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o OK- When everything is normal, the code has been recognized correctly. 
o No Tube - There was no tube detected. 
o No Code - A tube was detected, but the code could not be read. 
e Error Count: when the redundancy of the code is used to finalize the decoding, the number of used bits 
is written here. 
e Date: this will add the current date to the header. The format is: “yyyymmdd”. 
e Time: this will add the current time in the format “hhmmss’”. 


The records or tubes can be sorted column wise or row wise. The Sorting setting gives you these options. 
With the Include Field Names, an extra line will be inserted which describes the contents of the fields. 


With the option One Record per Line after each record a carriage return will be added. If you omit this check, all 
data per rack will be put on a single line. 


Records 
Sorting | Column Wise (401 B01 C01 | se 


iv Include Field Names 


Fields 


Line Start WI | Start text 


1 [Postion el 
2 | Ttuwe0 || 
Lane e 
4 {Erorcont Le 
dE 
dE 





Line End bw End text 


[ | Add Seperator 


iv One Record per Line 


6.4.6 Output 


The last section is the Output. Here the location of the output file can be assigned. Clicking on the button with the 
yellow folders icon will present a popup dialog which lets you select an existing folder. Also the composed 
filename is already shown. 


Output 


Folder | C:\Data Files\Output | | CS | [M] One Rack per File 





Example | FILE 000 70200039 20140820 113647.csv S O) EE 





An important option is the One Rack per File. This makes the difference between creating a new file for each 
rack or storing all rack data in one single file. Please note that the name composition is not variable. When 
date is added a new file is created each day. 


Then the last button is the Preview, this will pop-up a dialog showing the output file in table form. All the used 


options of the other sections will be used to show the final generated output file. Below is an example of such 
preview. 
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6.4.7 Output Settings for Integration into LabCollector LIMS 


For optimal integration of the Tracxer Code Reader Software into the LabCollector Laboratory Information 
Management System, the following settings are recommended. With these settings the output file can be 
imported directly into the LabCollector application. 


Tracxer 


CODE READER 

~- Formatting Records 
Sepertor Sorting 
WM Header 


Free Text 











Composition 








- ©) Footer 





Free Text 
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Dreem E 
header,000,70200039 20140820 ,114423 


Line Start | Position | Tube ID 


| Status 


| Error Count | Rack ID 


| Date 


| Line End 





Tube ID 
0005C300 
00050310 
0005C320 
0005C330 
00050340 
0005C350 
0005C360 
0005C370 
0005C301 


Line Start Position 
Start text A01 
Start text DOT 
Start text c01 
Start text D01 
Start text E01 
Start text F01 
Start text G01 
Start text HO) 
Start text A02 


0005C321 
0005C331 
0005C341 
00050351 
0005C361 
0005C371 
0005C302 


Start text 
Start text 
Start text 
Start text 
Start text 
Start text 
Start text 


0005C322 
0005C332 
0005C342 


LL OO 


Start text 
Start text 
Start text 


Status 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 


Error Count 


Co oo So ooo e ER e 


Rack ID 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 
70200039 


FAA am La Cam Cam Za 


Date 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 
20140820 


Ama OO 


Line End 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 
End text 


| footer | 


6.9 Users 


User Name | Full Name 


Tracxer 


CODE READER 


| Description 





| Level 





AdminNoPAD AdminNoPAD 


History 


SuperNoPAD SuperNoPAD 


Devices 


SN 


Settings 


Output File 


vi Automatically Logoff after 
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The Tracxer program has various levels of operation, to be used by different types of users: 
e Administrator ` System management, maintenance. 


e Supervisor system installation, management, maintenance. 
e User Daily operation of the system. 
e Logged off Nobody is logged in. 


Upon installation some users will be added to the list. 


In order to prevent inadvertent abuse of these levels, they are secured by passwords. It is the responsibility of 
the Administrator to maintain the user levels. 


Please notice that you will only see users on your own User Level and lower. 

You can specify to Automatically Logoff after a certain amount of time. 

By clicking on the Add button you start the New User pop-up dialog, in which you can define the characteristics 
of a new user on your own User Level or lower. Please pay attention to using the correct (lower or upper) case 


for the characters you type! 


New User 








User Name Password 








Full Name | Confirm Password | 


Description Level | User 





When for some reason usernames or passwords get lost the help desk can always make new users via the 
installed VPN connection for remote service. In real emergencies you can use the Keys button on the Login 
dialog as describes in paragraph Log on — Log off. 


6.6 Rights management 


This page shows the available levels and activity groups of the Tracxer program. By checking the various check 
boxes, you can allow User Levels to access specific activities. 
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Scanner CODE READER 


Privilege | Administrator | Supervisor | User | Logged off 





Rights Management 


OO 


User Management 
Close 
Devices Home - Edit Result 
P Home - Save Results 
| Scanner - Decode 


Settings 
Scanner - Decode Advanced 


Es Scanner - Source 
Output File Advanced - Devices 
Advanced - Settings 

Advanced - Output 


m 
m 
bé 
Zi 
m 
Š 
m 
m 
m 
Z 
m 
Zi 


OBO0O0URBBBO Sa 
OBOO0O0B8O0800 
OOOO0O0O000 800 


Advanced - Output Advanced 


Apply New Settings Undo Changes 





Incorrect use of the functions of this menu can lead to inaccessibility of the Tracxer program by other users or 
yourself. 


| We do not accept any responsibility for the consequences of unauthorized use of these functions or for leaking 
the User Names and/or Passwords that enable such misuse. 


7 SINGLE TUBE READ 


7.1 Enabling Single Tube Read 
The Single Tube Read option can be disabled or enabled by (un)checking the checkbox Enable Single Tube 
Read on page "Advanced => Settings". 
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Tracxer 


CODE READER 


r General — = — Single Tube Read - 


History Location | NoName | [M1 Enable Single Tube Read 


H [C] Show Close Button 


Devices [EFF EN FORTE EE 
Q Show Shutdown Button Scanner name thansiqhion 


bé z Show Location in Statusbar | Change Scanner translations | 


Settings 


[ | Beep with each Measurement 


ereraa control - 


vr 
[_] Enable Automation 


g Show Preview Dialog before 
Saving Results 


[C] Output Overwrite Warning 








-Folders 


Images | C:\Data Files\Images 
Log Files | C:\Data Files\Logs 


Apply New Settings Undo Changes 





7.2 Single Tube Read features 


2. The Home page will show an extra field for the Single Tube Read decode result, together with the button to 
copy this to the clipboard: 


If the option is enabled four things will happen in the User Interface: 


1. An extra icon (with an orange '1') will appear in the Home page toolbar on the left: 
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3. At the Scanner page an extra icon will appear in the toolbar on the left: 
f 1+ Tracxer cm5 








Cell Size [ 180 





Code Polarity | Both 


Code Type NW Datamatrix [C] Traxis 


Position 





Offset X | 35 








Size X | 





Tube Detection 


Threshold | 50 


[C] Show Filtered Image 


" ` Cells OK Mi Cells NOK 





| Apply New Settings | | Undo Changes 














Clicking this icon gives access to the setup page for Single Tube Read. Some things are fixed, like name and 
the number of rows and columns. Other things like offset and size of the scan area can be set. The functionality 
is basically the same as on the Genera page. 


d In the Scanner / Source page extra parameter settings appear for the Single Tube Read: 
















ET, pe eencuscreaceeereacusasescuscresercuncecusGrecuusmateaemecaesenensecscncnscseneunesenastesenessesenapecasteatucnsetecedsetecentatenenseseaustuaenedtqmecentecenentesenessatenessatececnesenennetenees 


OffsetX ` OffsetY ` Szen Size X 


ap 35 — 25 


E E, E E E E ET ET EECUCECELTT TT TCCCTLCLCeieTe PCerere errr Tt LCe eerie Cree Te Cree 


35 äp "238 







Source> Single Tube Read Single Tube Head: Positio 
X Y DX DY 





E, TT, E E E E E E tt TCCreTerer err errr rrr erer rei Cree cere Creer cree re 


2500 ~ 1500 420 


7.3 Reading the Single Tube 
After applying the right values for the parameters a Single Tube Read scan can be started with by clicking on the 
following icon: 


The single tube is decoded and the result, as aforementioned, is put into the result field at the 
Home Page, whence it can be copied to the clipboard. 
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8 INTERFACE - AUTOMATION 


The Tracxer application has different interface abilities - shown in the picture below. This paragraph describes the 
use of macro’s. 





8.1 Macro’s using in Automation-mode 

The Tracxer Code Reader Software has the ability to use the Macro functionality in Microsoft Excel. The 
following steps will help you to set up the Macro functionality of the Tracxer Code Reader Software. The macro 
definition has to be in the file. The templates are developed for Microsoft Office 2003. 


Step 1: oh Tracker 
To enable the macro examples it has to be marked at the p RS E 
control box which can be found in the Advanced > Scanner | Advanced | Logoff 


Settings menu in the Tracxer Code Reader Software. 


General 


Location | NoName | 


(| Show Close Button 





Please be sure the use of macros is enabled and you 
press ‘Apply New Settings’. 
Devices 


[C] Show Shutdown Button 


Kë f [| Show Location in Statusbar 


Settings 


IS Beep with each Measurement 


Contral 


|v Enable Automation 


g Show Preview Dialog before 
Saving Results 


F] Output Overwrite Warning 
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Step 2: | . Trecxer 
fete’ Gewerten Geek! Favorwten Extra Hek 
Open one of the following Excel files: E d ee 
As example or for demonstration purposes 4 Microsoft Deyn a E 
Excel files with the macro’s included are available in the J mhomation€ xampte?_384 
9 SC Aer xay SS 
following directory in the install folder: D Bei merka 
‘\Interfaces\Automation. caomuna 
eet ke 
8.2 Explanation of the Macro’s 
The most used examples are: 
1 AutomationExample.xls Transfers the code results in an 8x12 matrix layout. 
This can be used to identify quickly the imported results in a standard 
8x12-layout. 
2  AutomationExample_384.xIls Transfers the code results in a 16x24 matrix layout. 


This can be used to identify quickly the imported results in a standard 
16x24-layout. 
A AutomationExample2.xls Transfers the code results in 96 rows layout. 
Any new scan will be added after the previous results. 
This can be used to create a single file with more reading results. 
4  AutomationExample2_384.xls Transfers the code results in 384 rows layout. 
Any new scan will be added after the previous results. 
This can be used to create a single file with more reading results. 


Example 1 and 2 receive the data directly when called by the Tracxer Code Reader Software. The data is 
transmitted directly into the open excel file. This needs to be saved manually otherwise the data will be 
overwritten in the next scan. Example 2 is as reference to be used for the tube rack 384-format, but also for 24- 
and 48-format. 


Example 3 and 4 receive the data directly when called by the Tracxer Code Reader Software. The data is 
transmitted directly into the open excel file. The next scan will add the data into the file. It needs to be saved 
manually otherwise the data will be overwritten in the next run. Example 4 is as reference to be used for the tube 
rack 384-format, but also for 24- and 48-format. 


8.3 Standard Settings for the Macro’s 
In the Tracxer Code Reader Software go to Advanced > Devices > Automation and make sure the settings 
are set as displayed underneath here for the following Automation Examples: 


1 AutomationExample.xls 

2 AutomationExample_384.xls 
A AutomationExample2.xls 

4  AutomationExample2_384.xls 


Menu: [Advanced] > [Devices] > [Automation] 
Application: Excel 
Macro to Run: ImportResults 


Automation 





Application | Excel |% | 
Macro | ImportResults 


After these three steps you are ready for use. 


Please note that standard Macro to run is set to “macro name”. 
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8.4 Editing the macro in VBA 
The macro can be edited to fulfill personal needs, for example other locations or filenames. This can be done 
with the visual basic editor in Excel (Open Excel and go to Tools > Macro > Visual Basic editor). 


(aa Microsoft Visual Basic - Micronic_Fixed_Name.xls 





E Bestand Bewerken Beeld Invoegen Opmaak Foutopsporing Uitvoeren Extra Invoegtoepassingen ` Menster Help 
IN id ha A | | a | St S| @).| Rg 1, Kol 1 5 


Project - YBAProject x 





— Micronic_Fixed Name.xls - Module1 (Code) 


= | (Algemeen) | [Traxis 


+ Pé atpvbaen.xls (ATPYBAEN 





+] £8 EG2000 (EG2000.xla) ' Automation function, variables are required for macro to work 

D SS EuroTool (EUROTOOL.XLé Function Traxis(ByVal varOl As String, ByVal var02 As String, Bav: 
D gi funcres (FUNCRES.XLA) ByVal varO4 As String, ByVal varO5 As String, Bau 
C gi ¥BAProject (Micronic_Fi: ByVal varO? As String, ByVal varO6 As String, Bau 


— CN Microsoft Excel -objecter ' 

SST Sheet1 (Makro) 

£) Thisworkbook ' Traxis Macro 
i 





— CN Modules Macro recorded 7/25/01 by Micronic 
ei Module1 Revised by DVS 13/3/07 







' Open specified file in Exceg 
Workbooks.OpenText Filenam@:="C:\Output files\Filename.trx", 
x1lWindows, StartRow:=1, DataTYP Diet be L Aer BE: 
x1DoubleQuote, ConsecutiveDelimiter:=False, Tab:=False, Semic: 
e Comma:=True, Space:=False, Other:=False, FieldInfo: =Aarray (A: 
Array(zZ, 1), Array(3, 1), Array(4, 1)) 


The example for Access can also be observed via VBA Editor. 


9 INTERFACE - REMOTE DLL 


The Tracxer application has different interface abilities, shown in the picture below. This paragraph describes the 
use of DLL-Remote. 


R emote Coraci > 


e C+ zë DU-Remote 






Output to Accesa E ecol Morio’s (Office 200)) 







CF 
Er, Së 
HTML OS® Ache Re =— Output to Reports ite. osv, etc.) 
VBA — a 
e 
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The Tracxer Code Reader remote API allows you to control the Tracxer Code Reader Software from another 
computer. The programming of this remote function should be done by experienced people. For demonstration 
and as example a small program is supplied. 


After installing the Tracxer Code Reader Software a sample and source project can be found in the following 
directory in the install folder: :\Interfaces\Remote Control DLL. 


This folder contains the following information: 


- DLL: Contains the dll file(s) required to run the TracXerRemoteControl_VC.exe sample 
program. 

- ` Include: Contains the include file(s) required to build the sample. 

- — Lib: Contains the library file(s) required to build the sample. 


The Remote Lib.lio can be used using this API reference. 


- Project Source: Contains the Microsoft Developer Studio Workspace source code in which the demo 
program is described. This can be used as demonstration for own development. If you 
just want to run the sample as it is, copy the following files in the same folder on the 
remote computer and run the exe. 


o \DLL\CommTools.dll 
o  \Project Source\TracxerRemoteControl_VC\Release\TracXerRemoteControl_VC.exe 


9.1 Demo Remote Control with DLL 
The Tracxer RemoteControl is also installed with the Tracxer Code Reader Software. 


“> TracXer RemoteControl VC Sample 


Server connection 





Server Name 27.0.0. Connect 





Status Not connected 


Rack Type 


Result: 
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1 Install the Tracxer Code Reader Software on the main computer. 
The main computer should have the Security Dongle and the scanner connected. 


2 Check the IP-address of the main computer, this is necessary to connect to the remote computer. 
The IP-address cannot be found: 
Go to Start and Run. 
Type cmd.exe in the Run dialog box and type ipconfig. 
Now the IP-address should be shown. 
This IP-address you have to enter as ‘Server Name’ on the computer you are using as remote 
control. 


3 Run the Tracxer Code Reader Software on the main computer. 


4 ` Copy the following files in the same folder (i.e. C:\Program Files\Micronic\TracxerRemote) on the remote 
computer and run the exe. 


o \DLL\CommTools.dll 
o  \Project Source\TracxerRemoteControl_VC\Release\TracXerRemoteControl_VC.exe 


5 Open the program |racxerConirol.exe on the remote computer. 


6 When the Tracxer RemoteControl window pops up you have to enter the IP-address of the main 
computer in the server name box. 


/ After pressing ‘Connect’, the status should change to connected and now you are ready to scan from 
another computer. Enter the Rack Type and press the remote action wanted. 


9.2 Description of available functions in Remote Control DLL 
This reference will describe the available functions in the TracxerControl API. 


NOTIFICATION HOOK 

typedef void NotificationHook ( DWORD error, const char *errorString ); 

CONNECTTOSERVER 

Makes a connection to the Tracxer application. 

Prototype: long _stdcall crc_ConnectToServer (LPCTSTR szServerName); 

Parameter: szserverName — string containing computer name or IP-address. When running on the local 


system you can use 127.0.0.1 as server name. 
Return Value: ` Returns 1 when the call is successful. 
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DISCONNECT 
Disconnects from the Tracxer application. 
Prototype: void _stdcall crc_Disconnect ( void ): 


ISCONNECTED 

Returns the connection status. 

Prototype: long _stdcall crc_IsConnected ( void ): 

Return Value: Returns 0 when there is no connection and non-zero when a connection exists. 


CANCELWAITFORRETURN 
lf a scan has been started and timeout has not yet occurred this function can be used to cancel the call. 
Prototype: void _stdcall crc_CancelWaitForReturn ( void ); 


SETTIMEOUT 

Sets the timeout value for the call. 

Prototype: void _stdcall crc_SetTimeOut ( long ITimeOut ); 
Parameter: [TimeOut — timeout value in milliseconds 


GETTIMEOUT 

Retrieves the current set timeout value. 

Prototype: long _stdcall crc_GetTimeOut ( void ): 
Return Value: Timeout value in milliseconds 


SETENABLEPOPUPS 

Sets whether the application should show message popups. 

Prototype: void _stdcall crc_SetEnablePopups ( bool bEnablePopups ): 
Parameter: bEnablePopups — enable/disable pop ups. 


GETENABLEPOPUPS 

Retrieves the current set timeout value. 

Prototype: BOOL ` stdcall crc_GetEnablePopups ( void ): 
Return Value: Returns 1 if pop ups are enabled. 


SETNOTIFICATIONHOOK 
Prototype: void _stdcall crc_SetNotificationHook ( NotificationHook Hook ); 


GETRACKDATA 

Retrieves the rack data from the application. Formatting used is the same as defined on the application’s Output 

File page. 

Prototype: BSTR _stdcall crc_GetRackData (void ): 

Return Value: Large string containing formatted text. The actual data returned, including fields and 
separators, is defined on the application’s Output File page. 


SCANDECODEOUTPUT 
Scans an image, decodes the current image with the current parameters, gets the rack id and outputs the data. 
Prototype: long _stdcall crc_ScanDecodeOutput ( void ): 


Return Value: ` Returns 1 when the call is successful. 


SCAN 

Scans an image. 

Prototype: long _stdcall crc_Scan __( void): 
Return Value: Returns 1 when the call is successful. 
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DECODE 
Decodes the current image with the current parameters. 
Prototype: long _stdcall crc_Decode ( void ): 


Return Value: ` Returns 1 when the call is successful. 


GETRACKID 
Starts the barcode reader. 
Prototype: BSTR _stdcall crc_GetRackID ( void ): 


Return Value: Returns the read barcode as a string or NOREAD when no barcode was read. Returns NO ID 
when a timeout occurs. 


SETRACKTYPEBYINDEX 
Sets the rack type to decode. 
Prototype: long _stdcall crc_SetRackTypeBylndex ( int index ); 
Parameter: index — integer to define the rack type being used. The definition is as follows: 
0 — 384 tubes 
1 — 96 tubes 
2 — 48 tubes 
3 — 24 tubes 
4 — 12 tubes 
Example: crc_SetRackTypeBylndex( 1 ); or crc_SetRackTypeBylndex( TRAY_TYPE_96 ); 
Return Value: Returns 1 when the call is successful. 


SETRACKTYPEBYNAME 

Sets the rack type to decode. 

Prototype: long _stdcall crc_SetRackTypeByName ( LPCTSTR szRackType ); 
Parameter: szRackT ype — string to define the rack type being used. 


Current string names can be retrieved with the function GetRackTypeName( int index ). 
Example: crc_SetRackT ypeByName( “96 [8x12]’): 
Return Value: ` Returns 1 when the call is successful. 


GETRACKTYPE 

Prototype: long _stdcall crc_GetRackType ` ( void ); 

Return Value: ` Integer value for the rack type used. See SetRackType for rack type definitions. Returns -1 
when failed. 

GETRACKTYPENAME 

Gets the rack type of the specified index. 

Prototype: BSTR _stdcall crc_GetRackTypeName ( int index ); 

Parameter: index — integer to define the rack type being requested. 


Return Value: Large string containing returns a string describing the rack type if the index is valid; an empty 
string otherwise. Useful e.g. for filling a list box with rack types. 


AUTOMATIONAPPLICATION 

Sets the application to use for automation. 

Prototype: long _stdcall crc_AutomationApplication ( LPCTSTR szApplication ); 
Parameter: szApplication — string to define the application being used. 


Current options are Excel and Access. 
Return Value: Returns 1 when the call is successful. 


AUTOMATIONMACRONAME 

Sets the name of the macro to use for automation. 

Prototype: long _stdcall crc_AutomationMacroName  (LPCTSTRszMacroToRun ); 
Parameter: szMacroToRun - string to define the Macro being used. 


Return Value: ` Returns 1 when the call is successful. 
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10 INTERFACE - REMOTE ACTIVEX 


The Tracxer application has different interface abilities, shown in the picture below. This paragraph describes the 


use of the ActiveX Remote. 





Ay 


input hom tensi scanner or Keyboard (wedge| 
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The Tracxer Code Reader ActiveX allows you to control the Tracxer Code Reader Software from another 
computer. The programming of this remote function should be done by experienced people. For demonstration 
and as example examples are supplied. The ActiveX component can be found in the following directory in the 
install folder: :\Interfaces\Remote Control ActiveX. 


The folder :\lnterfaces\Remote Control ActiveX\Samples contains the demonstration programs and necessary 
files. These can be placed on the remote computer. 


10.1 Remote Control Active-X Installation 


For the PC with the Tracxer Code Reader application: 
The install program has copied TracxerRC_ActiveX.dll to the directory on your PC where the application 
'Tracxer.exe is installed. 


For the PC with the Remote Control: 


Use the windows program regsvr32 in the command window to register the control by feeding the control path to 
regsvr32; the path can contain spaces so it is necessary to enclose it in quotes. 
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Example: 


ec. C:\WINDOWS\system3?\cmd.exe 


CoN regsur3z TrackerRO_Activeds dll 





The control is installed on the PC. If registration is successful the following message is displayed: 


RepSvr3? 





10.2 Remote Control Active-X Controls 
Make sure the Tracxer application is active; if it is not the control will not start it. 


The following properties are available (Read & Write): 
String lpAddress 
the IP address of the PC containing the Tracxer Software 
long RackType 
the type of the rack to be scanned 
long TimeOut 
time to wait for the requested operation 
long EnablePopups 
enables or disables popup error boxes 


Properties can be used as follows: 


Read: int index = codeReader.RackT ype; 
Write: codeReader.RackType = TRAY_TYPE_96; 
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The following functions are available: 


ConnectToServer 

Makes a connection to the Tracxer application. 

Prototype: long ConnectTloServer (LPCTSTR szServerName ); 

Parameter: szserverName - string containing computer name or IP-address. When running on the local 


system you can use 127.0.0.1 as server name. 
Return Value: ` Returns 1 when the call is successful. 


Disconnect 

Disconnects from the Tracxer application. 

Prototype: void Disconnect ( void ); 
IsConnected 

Returns the connection status. 

Prototype: long IsConnected ( void ): 


Return Value: ` Returns 0 when there is no connection and non-zero when a connection exists. 
CANCELWAITFORRETURN 
lf a scan has been started and timeout has not yet occurred this function can be used to cancel the call. 


Prototype 

void CancelWaitForReturn ( void ): 

SetTimeOut 

Sets the timeout value for the call. 

Prototype: void SetTimeOut ( long TimeOut ); 
Parameter: TimeOut — timeout value in milliseconds 
GetTimeOut 

Retrieves the current set timeout value. 

Prototype: long GetTimeOut ( void ); 

Return Value: Timeout value in milliseconds 
SETENABLEPOPUPS 

Sets whether the application should show message popups. 
Prototype: void SetEnablePopups ` ( bool bEnablePopups ); 
Parameter: bEnablePopups — enable/disable pop ups. 
GETENABLEPOPUPS 

Retrieves the current set timeout value. 

Prototype: BOOL GetEnablePopups (void ): 

Return Value: Returns 1 if pop ups are enabled. 
SetNotificationHook 

Prototype: void SetNotificationHook ( NotificationHook Hook 1 
GetRackData 


Retrieves the rack data from the application. Formatting used is the same as defined on the application’s Output 

File page. 

Prototype: BSTR GetRackData ( void ): 

Return Value: Large string containing formatted text. The actual data returned, including fields and 
separators, is defined on the application’s Output File page. 
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ScanDecodeOutput 

Scans an image, decodes the current image with the current parameters, gets the rack id and outputs the data. 
Prototype: long ScanDecodeOutput (void ): 
Return Value: Returns 1 when the call is successful. 
Scan 

Scans an image. 

Prototype: long Scan ( void ): 

Return Value: Returns 1 when the call is successful. 
Decode 

Decodes the current image with the current parameters. 
Prototype: long Decode ( void ): 

Return Value: Returns 1 when the call is successful. 
GETRackID 

Starts the barcode reader. 

Prototype: BSTR GetRackID ( void ): 


Return Value: Returns the read barcode as a string or NOREAD when no barcode was read. Returns NO ID 
when a timeout occurs. 


SetRackTypeBYINDEX 
Sets the rack type to decode. 
Prototype: long SetRackTypeBylndex ( int index ); 
Parameter: index — integer to define the rack type being used. The definition is as follows: 
0 — 384 tubes 
1 - 96 tubes 
2 — 48 tubes 
3 — 24 tubes 
4 — 12 tubes 
Example: codeReader.SetRackTypeBylndex( 1 ); or codeReader.SetRackTypeBylndex( 
TRAY_TYPE_96 ); 
Return Value: Returns 1 when the call is successful. 


SetRackTypeBYNAME 

Sets the rack type to decode. 

Prototype: long SetRackTypeByName ( LPCTSTR szRackType ); 
Parameter: szRackType — string to define the rack type being used. 


Current string names can be retrieved with the function 

GetRackTypeName(int index ). 

Example: codeReader.SetRackTypeByName( “96 [8x12]”): 
Return Value: Returns 1 when the call is successful. 


GetRackType 

Prototype: long GetRackType ( void ): 

Return Value: Integer value for the rack type used. See SetRackType for rack type definitions. Returns -1 
when failed. 

GetRackT ypeNAME 

Gets the rack type of the specified index. 

Prototype: BSTR GetRackTypeName ( int index ); 

Parameter: index — integer to define the rack type being requested. 


Return Value: Large string containing returns a string describing the rack type if the index is valid; an empty 
string otherwise. Useful e.g. for filling a list box with rack types. 
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AUTOMATIONAPPLICATION 

Sets the application to use for automation. 

Prototype: long AutomationApplication ( LPCTSTR szApplication ); 
Parameter: szApplication — string to define the application being used. 


Current options are Excel and Access. 
Return Value: Returns 1 when the call is successful. 


AUTOMATIONMACRONAME 

sets the name of the macro to use for automation. 

Prototype: long AutomationMacroName ( LPCTSTR szMacroToRun ); 
Parameter: szMacroToRun - string to define the Macro being used. 


Return Value: ` Returns 1 when the call is successful. 


10.3 Remote Control Active-X Visual Basic Example 
Now open your Visual Basic program on the remote PC in the directory “VB Demo” and add the component: 


Components 


Controls | Designers Insertable Objects 


Close Window OLE Control module 
closer Actives Control module 
cnfgprts GLE Control module 

wa) odeReaderControl 1.0 
CompatU 1.0 Type Library 
ComponentOne ¥SFlexrid 7.1 (Light) 
ComponentOne VSFlexGrid 8.0 (Light) 
ComSnap 1.0 Type Library 
Contents OLE Control module 
Crystal Analysis Common Controls 1.0 
chy OLE Control module 


DAQBench Graphs Actives Controls Vver?.4 S 
DHTML Edit Control For IES EE | 
S | | Selected Items Only 


CodeReadercontrol 1.0 


Location: Or)... .ReleaseM, Vcodereadercoptrol, dll 


eg le _| 


Use the Browse button to locate the control on the Tracxer PC, click OK. 
The component becomes visible in the tool bar and can, after selecting it, be drawn on the dialog: 





w. Formi 
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The code contains the line: 
CodeReaderCtl1.loAddress = “127.0.0.1” 


This has to be changed to the IP address of the PC running the Tracxer program. 


After that the control methods can be called: 
CodeReaderCtl1.Scan 
CodeReaderCtl1.Decode 


10.4 Remote Control Active-X C# Example 
A C# example program has been added that shows all functionality. The reference to 'CodeReaderControl' has to 
be added. 





Solution Explorer - Solution ‘CoderRe... w H 


3 | a 

P Solution ‘CoderReaders NET (1 project) 

E Se? Coderbeader? NEI 

H ai Properties 

B- | References 
dSlCodebeaderCortrol 
+) System 


Ao Swekerm Core 








This can be done with “Add reference” and the “Browse” tab. 


The code contains the line: 
codeReader.|pAddress = “127.0.0.1” 


This has to be changed to the IP address of the PC running the Tracxer program. 
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11 INTERFACE - TCP/IP SOCKET COMMUNICATION (IO MONITOR) 


The IO Monitor is a TCP/IP server interface which allows an external client to control the Tracxer Code Reader 
Software. 


11.1 Accessing the IO Monitor 

The IO Monitor user interface can be found under the “Advanced” tab (see the figure below). The server IP 
address is equal to the IP address of the computer with the Tracxer installation. The server listening port is set at 
2500 and the receive buffer size is 5000 bytes. 


The server automatically starts up together with the Tracxer Code Reader Software. 





op» Tracxer arc x 


Scanner Advanced Log off CODE READER 


Server | 10 | 0 | 0 | 104 | 
Port | 2500 


Receive Buffer Size | 5000 


Output File 


kb | Message 


There are no items to show in this view. 


IO Monitor 


own (paa) oo 
Apply New Settings Undo Changes 





11.2 1O Monitor Commands 


"show layouts" 

Displays the possible layouts (eg.): 
e "16x24" 

"8x12" 

"6x8" 

"4x6" 

"3x4" 


“get layout" 
Displays the active layout 


MICRONIC o 


Tracxer Code Reader Software User Manual 


"set layout" 
Selects the active layout e.g. "set layout 8x12" 


"scan box" 
scans the rack and perfoms the decoding 


“scan tube" 
Perfoms a single tube scan 


“get scanresult" 
Collects the results of the decode process of the most recent scan event in string format. The string format is 
determined by the ‘Output File’ settings (see paragraph 6.4 Output File). 


"read rackid" 
Collects the RackID as string if the "Rack ID Source" option has been configured to scan the rack barcode 


"state" 
Returns the current status of the Tracxer Server: 
"idle" - Tracxer is waiting for the next command 
"scanning" - Tracxer is busy scanning 
"dataready" - Tracxer has completed the scan and the decode data is available 


"help" 
Returns all the implemented commands 


"close" 
Closes the connection 


12 ADDITIONAL INFORMATION 


12.1 Update Security Dongle 
Older versions of Dongles might not work with the Tracxer Code Reader Software. When a Security Dongle is 
used which is not valid, the following messages will occur. 
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MIL DLL Message x 





Error in OC: Application free operation error, 
Application was not freed, 

Choose Yes to continue error prints 
Choose No to discontinue error prints 
Choose Cancel to exit application 


i No | Cancel | 











Please contact your reseller for an upgrade. 


The following procedure can update the security Dongle. 


1 Open the file FleldExUtil.exe in the folder C:\Program Files\Micronic\Tracxer\ 


2 Press the button Get Locking Code and a text string will Field Exchange Utility e 
appear in the field above the button. Press the “copy to a 
clipboard” or “save to disk” buttons above it to execute the 

| = | 


BEINVJHIAHXATAAEBDH 


appropriate action. 


3 E-mail this string to your contact at Micronic. 


4 You will receive an e-mail with a new text string which should 
be placed in the second field. You can either type it in or use 
the “paste” or “load from disk” buttons. 


BEIINJHIAH*ATAAEBDH 
Get Locking Code | 


e| el 
BSJPGREUDZIQUIFSUY 


Update License | 
Help | 
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5 With the new text string in the bottom field press the Update E e x! 
License button. 
lf all went right a “success!” message will be displayed. : 
| fal 
To avoid problems it is advisable not to manually type in the BENIMJHIAHATAAEBDH 


strings. FieldExUtil [X] 


Update License | 
Help | 





12.2 Specific Scanner Settings 


The first time use can result in a visual wrong placing of the rack-image. A one-time applying of the rack solves 

this issue (Go to Scanner — Source — Scan — Apply new settings). In case it will not be applied at once, the rack 

position and scan offset have to be set manually. When you click and hold your mouse inside a cell, a popup will 
be seen in which you can type the values. See separate document for correct setting. Sometimes the scan area 
has to be adjusted (blue grid fine tuning). See for more information the ‘Getting started guide’. 


In this table the standard settings for different scanners are described. 


Rack Position Scan Offset 


Width Height Xo yY Rotate Vertical 
150 | Off Vertical 
RS297 - Epson V33 Off Vertical 


RS297 - Epson V37 ? ? ? ? Off Vertical 
| | | | Left Vertical 
i i i i Left ? Vertical 
RD235 - AVAG : ! : ! Left 
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Rack Position: Rack Scan Offset & Image Processing 


o Position - = 


Offset A Y Scanner Advanced Log off 
size X 2540 Y 1700 








| g - Scanner 
General Source RS210 - Fujitsu Fi65 | Kë 
— Rack Scan 


Miche: 


Single Tube 


Read 





12.3 Specific BC210 / BC235 (MS-2) Settings 


The standard settings for the BC210 / BC25 are also available in the file [Micronic Tracxer MS-2 settings.esp] 
located at :\Drivers\Microscan. 


Parameters ESP Values 
EE 
_.. Communications Mode RS232 
bel, HG 223 
|- Baud Rate 9600 
i Parity Even 
|- Stop Bits One 
-$ Data Bits Seven 
... Host Protocol Point-to-Point 
5- Keyboard Mapping English (USA) 
Cap Lock Mode Off 
-L Numeric Key Alpha Numeric 
5- Preamble Disabled 
-L Preamble Characters CR 
=). Postamble Enabled 
. Postamble Characters CR LF 
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Parameters ESP Values 
ee Read Cycle 
.. Number of Symbols Single 
.. Time Between Identical Decodes 0 
Trigger Mode Serial Data 
=). Serial Trigger 
|. Character (Delimited) t 
|... Start Character (Non-Delimited) 0x00 NUL 
|__|. Stop Character (Non-Delimited) 0x00 NUL 
No Decode Timeout 2 
 Decodes Before Output 0 
=} No Read Message Enabled 
Message NOREAD 
~~ Shutter Speed Automatic 
.-. Beeper On Good Read 
Parameters ESP Values 
EL symbologies 
Gi. Code 39 Enabled 
H- Code 128/EAN Enabled 
5- Interleaved 2 of 5 Disabled 
e, Codabar Disabled 
5- UPC/EAN 
bu UPC-A Status Enabled 
-- UPC-E Status Enabled 
L. EAN-8 Status Enabled 
? EAN-13 Status Enabled 
i Supplementals 
"fq Output Format 
5- Code 93 Disabled 
e Industrial 2 of 5 Disabled 
H- MSI Code Disabled 
a). Plessey Code Disabled 
+- DataBar Expanded Disabled 
`. DataBar Limited Disabled 
+- DataBar Omnidirectional Disabled 
&)- China Postal Code Disabled 
þer PDF417 Enabled 
.... Symbology Identifier Disabled 
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12.4 Display problems Windows 7 


Due to the ability of Windows 7, the font size or type can differ from the originally developed font size or type for 
the Tracxer Code Reader Software. This can result in a false representation of the screen. 


In this paragraph a general solution will be described. The general solution is: 
- No Aero theme 
- ` Ensure the correct font type is installed 
- 100% scaling will solve the problem 
- Windows XP style DPI Scaling 


COOE READER 











Ensure the correct font type is installed 


1. Unzip the folder ‘FontsA.zip’ (which can be found in the Tracxer install folder) somewhere on your hard disk. 


2. Install the correct font types: serifer.fon, sserife.fon and sserifer.fon. by right clicking on each font type. Click 
‘Install’ (administrative privileges might be asked). 


Change the display size in Windows 7 
The DPI setting you set below only affects the current user account that you are logged in, and not all users. 


Setting the DPI size to a smaller number or percentage will decrease all items size on the display, while setting 
the DPI size to a larger number or percentage will increase all items size on the display. 
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Typically, the higher the dots per inch (DPI), the better the fonts will look. If you set the DPI higher than 96, and 
you are running a Windows Aero theme, the text and other items on the screen might appear blurry in some 
programs that are not designed for high-DPI display in this version of Windows. You can avoid this issue by 
using legacy DPI scaling (Windows XP style DPI scaling) for these programs. 


OPTION ONE: CHANGE THROUGH DISPLAY SETTINGS 


1. Open the Control Panel (All Items View). 
A) Click on the Display icon. 


B) Go to step 4. 
OR 


2. Right click on an empty area of your desktop and click on Personalize. (See screenshot below) 
NOTE: The Windows 7 Starter and Home Basic editions do not have Personalize included in them. 


View b 
Sort By b 
Refresh 


NVIDIA Control Panel 
New > 


PR Screen Resolution 
E Gadgets 


| 
| E Personalize 


A) Towards the bottom left corner, click on the Display link. (See screenshot below) 


1252x795 195kb JPEG 





B) Go to step 4. 
OR 
3. Right click on an empty area of your desktop and click on Screen Resolution. (See screenshot below step 2) 


A) Click on the Make text and other items larger or smaller link. (See screenshot below) 
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003x457 993kb JPEG 


5. To Select a DPI Size 
A) Dot a size that you want for the Display DPI size. (See screenshot above) 


e Smaller - 100% = 96 DPI (Pixels/Dots Per Inch) 
e Medium - 125% = 120 DPI (Pixels/Dots Per Inch) 
e Larger - 150% = 144 DPI (Pixels/Dots Per Inch) 
Standard 100% is needed. 

B) Go to step 7. 


6. To Set a Custom DPI Size 


A) In the left pane, click on the Set custom text size (DPI) link. (See screenshot below step 4) 


User Manual 


B) To the right of Scale to this percentage of normal size, click on the drop down arrow and select a 


percentage you want the DPI size to be. (See screenshot below step 6D) 


C) Ifneeded, check the Use Windows XP style DPI scaling box to make text and items clearer in 
programs that are not designed for higher settings than 96 DPI (100%). (See screenshot below step 6D) 


D) Click on OK. (See screenshot below) 
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For a custom DPI setting, select a percentage from the list, or 
drag the ruler with your mouse. 








9 point Segoe UI at 96 pixels per inch. 


Tite weep aye rreara] (oe) 





7. Click on the Apply button. (See screenshot below step 4) 


8. Click on the Log off now button to apply the DPI changes. (See screenshot below) 
WARNING: This will log you off immediately. Be sure to save anything you are working on before you click on 
this. 


A You must log off your computer to apply 
these changes 


Save any open files and close all programs before you 
log off, 





9. Log back on. 


OPTION TWO: CHANGE DPI MANUALLY IN REGISTRY EDITOR 
1. Open the Start Menu, then type regedit in the search box and press enter. 
2. If prompted by UAC, then click on Yes. 


3. In regedit, navigate to the location below: (see screenshot below) 
HKEY_CURRENT_USER\Control Panel\Desktop 
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4. In the right pane of Desktop, right click on LogPixels and click on Modify. (see screenshot above) 


Fpe 
REG DAKORD 
FEG DAIRI 
REG DWORD 
EEG DACH 
GSI 
REG DACHSEN 
EG sr 
EG DMR 
REG ST 
FG ST 
EG ST 
EG KT 
EG ST 


EN 


JPEG 


Data 
a (21 
SL? [71 
GeKKKKTZ 7) 
e Cl be ZER wt 
1 

To A] 
4x 

DO CH 
ZELT 

7 
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NOTE: /f you do not have the LogPixels DWORD value, then right click on a empty space in the right pane of 


Desktop, click on New and DWORD (32-bit) Value, type LogPixels, and press Enter. 


5. In the edit/modify window, select (dot) Decimal, type in the registry data value from the table below for the 


DPI setting that you want to use, and click on 


OK. 


Smaller - 100% 96 
Medium - 125% 120 
Larger - 150% 144 


100% is valid. 


Edit DWORD (32-bit) Val 


Rase 


Hexadecimal 


[ok Il Ge _| 


345x206 41ikb JPEG 


6. Close regedit. 


7. Log off and log on, or restart the computer to apply. 


Source: 
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12.5 Possible issues by upgrade from version 1.0.0. to 2.0.0. 
When an upgrade from version 1.0.0. is performed the following may occur: 
e Dongle not valid. 


e Not able to log in. Reason for this improper use is that not all necessary files are placed in the correct 
folder. 


e Notall necessary folders are posted on the correct location. 
e Not al settings are recognized. 


Hereby a short solution to solve this defectiveness. The cause of these failures are different Window versions, 
Windows-installer problems and Security issues. 


During the installation of version A1.0.0. the following folders will be created on the computer: 


e ‘C:\Program Files (x86)\Micronic\Tracxer’ or ‘C:\Program Files\Micronic\Tracxer’ 
e ‘C:\Data Files’ 


© Data Files 


File Edit View Favorites Tools Help 


© sack hi ©) Ba ES Search > Folders 


Mame + Size Type Date Modified 
[O AutoSave Folder 24-11-2011 14:44 
(Database Folder 24-11-2011 14:44 
' Other Places | (Images Folder 24-11-2011 14:45 
L [Logfiles Folder 24-11-2011 14:46 
; (Recipes Folder 24-11-2011 14:46 
petal (Review Folder 24-11-2011 14:44 
“security. ini Configuration Settings 24-11-2011 14:46 
C$ Tracxer.ini Configuration Settings 24-11-2011 14:46 

[E] Tracxer.rcp RCP File 2-9-2011 12:10 





When installing version A2.0.1 the following messages will be seen: 


Tracxer 


\ ? / This setup will perform an upgrade of 'Tracxer', Do you want to continue? 


InstallShield Wizard Complete 
Resuming the InstallShield Wizard for Tracxer 


The InstallShield Wizard has successfully installed Tracxer. 
Click Finish to exit the wizard. 

Wizard will complete the installation of Tracker on your 

computer. To continue, click Next. 





Cancel 





It looks if a normal and correct upgrade is performed. Next steps will show if this is true. 
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12.6 No Username or log-in ability 
During startup you will need to log in with a User name and Password. Standard User names are ‘AdminNoPWD’ 
and ‘SuperNoPWD’, both without the need of a password. If this will not work the following will/can be seen. 


User Mame | 


Password | 


Unknown User Name !OPlease Try again. 





Go the folder C:\Data Files and make a new folder with the name Tracxer. Place in this folder the two files 
Tracxer.ini and Securit.ini which are originally placed in C:\Data Files. 


We Tracxer 


File Edit wiew Favorites Tools Help ae 


€) Back ~ > a Ee Search em Kä Folders E 
Address |Í) C:\Data Files\Tracxer ge (È CA4Data Files\Tracxer e ei C:\Data Files\Tracxer si EI Go 


Folders Mame —— Size = Type Date Modified 





EI ge Lacal Disk (Cs) | A -C$ Security.ini 4 KE Configuration Settings 24-11-2011 14:50 
CH background = “$ Tracxer.ini 6KB Configuration Settings 24-11-2011 14:50 


(3 Corel 

E CH Data Files 
fe Aubosayve 
LC Database 

= |) Images 

(C LogFiles 
IC Recipes 
CH Review 
KH Tracxer 





MICRONIC s4 


Tracxer Code Reader Software User Manual 


12.7 No Folder/File locations available 
During the upgrade potential not all folders are positioned at the correct location. The following message will 
occur: 


Tracxer 


Default File Locations 


Auto Save C:*D ata Files Tracwer4uto5 av 


Database [CAData Files\Qutput 
Beelden [CAData Files\Images 
Logbestanden [CADataFiles\Logs 
Recept [CAData Files\Tracser 
Terugzien [CAData Files\Tracwer\Review 


Seege 


Creeer ontbrekende directories 


Modify and Apply the new folders. Close the screen to continue with the program. 
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